home *** CD-ROM | disk | FTP | other *** search
/ Mac Mania 2 / MacMania 2.toast / Demo's / Tools&Utilities / Programming / Convert•Projects 1.0b5 / About Convert•Projects next >
Encoding:
Text File  |  1994-06-02  |  9.2 KB  |  237 lines  |  [TEXT/R*ch]
  1. (This file was created by BBEdit 2.5, a product of Bare Bones Software.
  2. It was written in Monaco 9, with four spaces per tab.)
  3.  
  4. This document is current as of -prerelease- version 1.0b5 of the
  5. software, written on June 2, 1994.
  6.  
  7. [Prerelease note: As of 1.0b5, the following limitations apply:
  8.         
  9. -    The method for reading THINK C projects relies on launching
  10.     the THINK Project Manager, instructing it to open the project,
  11.     and then asking it for the list of files. It’s elaborate, and
  12.     needs to be exercised.
  13.  
  14. -    We •strongly• recommend that before converting a project,
  15.     that you do a full scan of the source files. To do this,
  16.     choose the “Make...” command from the THINK Project Manager’s
  17.     “Source” menu, un-check the “Quick Scan” check box in the
  18.     dialog, click “Use Disk”, and when the scan is complete,
  19.     click “Don’t Make”.
  20.     
  21.     If you don’t do this, you risk running afoul of a bug in
  22.     the TPM which will cause garbage file names to be returned
  23.     to Convert•Projects.
  24.     
  25. This version is a “public beta”; it is substantially feature-complete,
  26. and does what it says it does. It is in need of real field-testing, so
  27. if you have problems using it that aren’t covered here, or if you
  28. run into anomalous behavior, please contact us (preferably via e-mail).
  29. ]
  30.  
  31. About Convert•Projects
  32. ----- ----------------
  33.  
  34. Convert•Projects is a utility which will read a THINK C or THINK Pascal
  35. product, and produce an equivalent (or nearly so) Code Warrior project.
  36. This is particularly useful for large projects, in which manually
  37. adding and segmenting the project would be tiresome or impractical.
  38.  
  39. Convert•Projects does not modify the project documents you feed it,
  40. so you can continue to use them, should the need arise.
  41.  
  42. With Convert•Projects, you can convert THINK Pascal version 4.0 or
  43. later, and THINK C version 6.0 or later (including Symantec C++ 6.0)
  44. project documents.
  45.  
  46. How to Use Convert•Projects
  47. --- -- --- ----------------
  48.  
  49. Using Convert•Projects is easy - just drag & drop your project
  50. document(s) onto the Convert•Projects icon. Convert•Projects will read
  51. in your THINK C or THINK Pascal project document, locate and analyze the
  52. files, and produce a Code Warrior project. Subject to the preferences
  53. settings (see below), more than one project may be produced, e.g. one
  54. for 68K and one for PowerPC.
  55.  
  56. Some files cannot be used by Code Warrior. Specifically, Code Warrior
  57. cannot (and will never be able to) load THINK C project documents that
  58. are included as libraries (the ANSI libraries are an example of this);
  59. “standard” THINK C library files (created with “Build Library”) likewise
  60. cannot be used by Code Warrior, nor can library files created in the MPW
  61. ".O" format (including THINK Pascal 3.0 or later library files).
  62. Convert•Projects will exclude these libraries when writing out the new
  63. project, and will advise you of the libraries that have been excluded.
  64. It’s up to you to reconstitute those libraries - if the source is
  65. available, then include the source directly in the Code Warrior project;
  66. otherwise, contact the library vendor for a version that works with Code
  67. Warrior.
  68.  
  69. Preferences Settings
  70. ----------- --------
  71.  
  72. Convert•Projects provides the following settings in its “Preferences” 
  73. dialog:
  74.  
  75. -    Emit 68K Project: If checked, Convert•Projects will write out a
  76.                         project usable by the 68K versions of the
  77.                         Code Warrior environment.
  78.                         
  79. -    Emit PowerPC Project: If checked, Convert•Projects will write out a
  80.                         project usable by the PowerPC versions of the
  81.                         Code Warrior environment.
  82.                         
  83. -    Remove Missing Files: If checked, Convert•Projects will filter out
  84.                         files that it couldn’t locate when loading 
  85.                         the THINK-format project, and advise you
  86.                         of the files that have been filtered.
  87.                         
  88. -    Add Standard Libraries: If checked, standard libraries (ANSI.Lib for
  89.                         Code Warrior C & C++, MW/Runtime.Lib for Code Warrior
  90.                         Pascal) will be added to the created project.
  91.                         
  92. -    Add Toolbox Glue: If checked, toolbox glue (MacOS.Lib) will be added
  93.                         to the created project.
  94.  
  95. -    Ask for Project Name: If checked, Convert•Projects will always ask you
  96.                         (via Standard File) to specify the name and location
  97.                         of each project that it writes out. Although this
  98.                         compromises the drag-and-drop-ness of the utility,
  99.                         it can occasionally be useful.
  100.  
  101. Limitations
  102. -----------
  103.  
  104. The following limitations apply when using Convert•Projects:
  105.  
  106. -    Convert•Projects uses the services of the THINK Project Manager to
  107.     determine the files and segmentation of a THINK C project. For this
  108.     reason, you’ll need enough memory so that Convert•Projects can launch
  109.     the THINK Project Manager.
  110.  
  111. -    Although it automates part of the conversion process, Convert•Projects
  112.     is -not- a “magic bullet” that will get you up and running with Code
  113.     Warrior in minutes. How long it takes you to get your programs ported
  114.     depends on the nature of your code.
  115.     
  116. -    Convert•Projects is not, nor will it ever be, able to convert library
  117.     files from THINK or MPW formats to the Code Warrior format. If you
  118.     have a library which is not available in source or Code Warrior
  119.     library form, contact the vendor of the library.
  120.     
  121. -    Convert•Projects makes a reasonable effort to locate the files
  122.     specified in the input projects, and to write out projects such that
  123.     Code Warrior can readily find the source files. To help this process,
  124.     we recommend that you build the project you want to convert, so that
  125.     all source files’ locations can be determined. (If you’re using THINK
  126.     C, bring up the “Make...” dialog, turn off the “Quick Scan” check box,
  127.     and click the “Use Disk” button.)
  128.  
  129. -    Depending on the arrangement of your directory structures, you may need
  130.     to add some search paths to the Code Warrior project so that Code
  131.     Warrior can locate all of the files in that project.
  132.     
  133. -    Convert•Projects does not address the issue of resource files; Code
  134.     Warrior uses the same convention as THINK C for naming the project’s
  135.     resource file; you should make a duplicate of your resource file and
  136.     give it the correct name after converting your project.
  137.     
  138.  
  139. Miscellaneous Comments
  140. ------------- --------
  141.  
  142. -    Convert•Projects is free.
  143.  
  144. -    We plan to keep Convert•Projects up to date as necessary to accomodate
  145.     changes to Code Warrior. Therefore, if you have problems with
  146.     Convert•Projects, please let us know so that we can resolve them.
  147.     If Code Warrior has difficulty with a project that Convert•Projects
  148.     creates, or if Convert•Projects has difficulty processing your
  149.     projects, we definitely want to know about it.
  150.  
  151. -    Please note that we have no plans to turn Convert•Projects into a
  152.     source converter, and we cannot offer assistance with porting your code
  153.     to work with Code Warrior.
  154.     
  155. -    If you have questions or problems with Convert•Projects, please contact
  156.     us by one of the following means:
  157.     
  158.     Internet: bbedit@world.std.com
  159.     CIS: 73051,3255
  160.     AppleLink: BARE.BONES
  161.     Fax: (508) 651-7584
  162.     Phone: (508) 651-3561
  163.     Mail:    Bare Bones Software
  164.             1 Larkspur Way #4
  165.             Natick, MA 01760
  166.             
  167. Attributions
  168. ------------
  169.  
  170. Convert•Projects was written by Rich Siegel.
  171.  
  172. Convert•Projects is based on Drop•Shell, which was written by
  173. Leonard Rosenthol, Marshall Clow, and Stephan Somogyi.
  174.  
  175. Thanks to Greg Galanos and Berardino Baratta of Metrowerks, and
  176. to John McEnerney, for their assistance.
  177.     
  178. Copyright & Distribution Information
  179. --------- - ------------ -----------
  180.  
  181. Convert•Projects is written by and copyright ©1994 Richard M. Siegel;
  182. all rights reserved.
  183.  
  184. This software may be redistributed under the following conditions:
  185.  
  186. -    Convert•Projects may not be sold, either by itself or in combination
  187.     with any other product, without the express written permission of
  188.     Richard M. Siegel.
  189.     
  190. -    This document and the Convert•Projects application must be distributed
  191.     together, in the same directory on a Finder-mountable volume, or in the
  192.     same compressed-file (e.g. StuffIt or Compact Pro) archive.
  193.     
  194. -    The Convert•Projects package may be freely posted to any BBS or
  195.     information service which charges its users for general connect and
  196.     downloading time; the package may -not- be posted to any BBS or
  197.     information service which will charge for the specific right to
  198.     download Convert•Projects.
  199.     
  200. -    Commercial publishers and distributors of CD-ROM software collections
  201.     may not include the Convert•Projects package without the express
  202.     written permission of Richard M. Siegel.
  203.  
  204. About Bare Bones Software
  205. ----- ---- ----- --------
  206.  
  207. Bare Bones Software, founded in May 1993, is the developer and publisher
  208. of the following software:
  209.  
  210. -    BBEdit 2.5, the best-of-class text editor for programmers, on-line
  211.     service users, and anyone else who needs to edit ASCII text files with
  212.     maximum performance and minimum fuss. BBEdit 2.5 features integration
  213.     with THINK C/Symantec C++ 6.0, THINK Reference, MPW ToolServer, and
  214.     support for THINK Pascal and Code Warrior projects, as well as an
  215.     assortment of unique and powerful features. Write for a free demo
  216.     disk.
  217.     
  218. -    BBEdit Lite, the popular freeware version of BBEdit.
  219.  
  220. -    Convert•Projects, a freeware utility to convert THINK C and THINK
  221.     Pascal project documents to Metrowerks Code Warrior format.
  222.     
  223. -    Drop•PS, a freeware PostScript™ downloader for network-connected
  224.     printers.
  225.  
  226. For additional information, contact us at one of these addresses:
  227.  
  228. Internet: bbedit@world.std.com
  229. CIS: 73051,3255
  230. AppleLink: BARE.BONES
  231. Fax: (508) 651-7584
  232. Phone: (508) 651-3561
  233. Mail:
  234.     Bare Bones Software
  235.     1 Larkspur Way #4
  236.     Natick, MA 01760
  237.